Node / ReticulumProjects / MeshChatX.git / files / meshchatx / src / backend / management_identities.py

Displaying Raw • Download

T8b949e# SPDX-License-Identifier: 0BSD

T8b949e"""List and create Reticulum management identity files.

These live under <reticulum_config_dir>/storage/identities/ and are used by

rnstatus / rnpath remote queries (-i), rnx, and rnsh.

"""

Tff7b72from T7ee787__future__ Tff7b72import Te6edf3annotations

Tff7b72import T7ee787os

Tff7b72import T7ee787re

Tff7b72from T7ee787typing Tff7b72import Te6edf3Any

Tff7b72import T7ee787RNS

Te6edf3_SAFE_NAME_RE Tff7b72= Te6edf3reTff7b72.Td2a8ffcompileTb4b4b4(Ta5d6ffrTa5d6ff"Ta5d6ff^[A-Za-z0-9][A-Za-z0-9._-]Ta5d6ff{Ta5d6ff0,63}$Ta5d6ff"Tb4b4b4)

Tff7b72def Td2a8ffidentities_dirTb4b4b4(Te6edf3reticulum_config_dirTb4b4b4: Tffa657str Tff7b72| Tff7b72NoneTb4b4b4) Tff7b72-Tff7b72> Tffa657strTb4b4b4:

T8b949e"""Return the RNS identities directory for a config root."""

Tff7b72if Tffa657isinstanceTb4b4b4(Te6edf3reticulum_config_dirTb4b4b4, Tffa657strTb4b4b4) Tff7b72and Te6edf3reticulum_config_dirTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4:

Te6edf3root Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexpanduserTb4b4b4(Te6edf3reticulum_config_dirTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3root Tff7b72= Tffa657getattrTb4b4b4(Te6edf3RNSTff7b72.Td2a8ffReticulumTb4b4b4, Ta5d6ff"Ta5d6ffconfigdirTa5d6ff"Tb4b4b4, Tff7b72NoneTb4b4b4) Tff7b72or Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexpanduserTb4b4b4(

Ta5d6ff"Ta5d6ff~/.reticulumTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tff7b72return Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Ta5d6ff"Ta5d6ffstorageTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffidentitiesTa5d6ff"Tb4b4b4)

Tff7b72def Td2a8ff_safe_nameTb4b4b4(Te6edf3nameTb4b4b4: Tffa657strTb4b4b4) Tff7b72-Tff7b72> Tffa657strTb4b4b4:

Te6edf3cleaned Tff7b72= Tb4b4b4(Te6edf3name Tff7b72or Ta5d6ff"Ta5d6ff"Tb4b4b4)Tff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)

Tff7b72if Tff7b72not Te6edf3_SAFE_NAME_RETff7b72.Td2a8ffmatchTb4b4b4(Te6edf3cleanedTb4b4b4)Tb4b4b4:

Tff7b72raise Tf85149ValueErrorTb4b4b4(

Ta5d6ff"Ta5d6ffIdentity name must be 1-64 characters: letters, digits, ., _, -Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tff7b72return Te6edf3cleaned

Tff7b72def Td2a8ff_identity_infoTb4b4b4(Te6edf3pathTb4b4b4: Tffa657strTb4b4b4, Te6edf3nameTb4b4b4: Tffa657strTb4b4b4) Tff7b72-Tff7b72> Tffa657dictTb4b4b4[Tffa657strTb4b4b4, Te6edf3AnyTb4b4b4] Tff7b72| Tff7b72NoneTb4b4b4:

Tff7b72tryTb4b4b4:

Te6edf3identity Tff7b72= Te6edf3RNSTff7b72.Td2a8ffIdentityTff7b72.Td2a8fffrom_fileTb4b4b4(Te6edf3pathTb4b4b4)

Tff7b72except Tf85149ExceptionTb4b4b4:

Tff7b72return Tff7b72None

Tff7b72if Te6edf3identity Tff7b72is Tff7b72NoneTb4b4b4:

Tff7b72return Tff7b72None

Tff7b72tryTb4b4b4:

Te6edf3identity_hash_raw Tff7b72= Te6edf3identityTff7b72.Td2a8ffhash

Tff7b72if Te6edf3identity_hash_raw Tff7b72is Tff7b72NoneTb4b4b4:

Tff7b72return Tff7b72None

Te6edf3identity_hash Tff7b72= Tffa657bytesTb4b4b4(Te6edf3identity_hash_rawTb4b4b4)Tff7b72.Td2a8ffhexTb4b4b4(Tb4b4b4)

Tff7b72except Tf85149ExceptionTb4b4b4:

Tff7b72return Tff7b72None

Tff7b72return Tb4b4b4{

Ta5d6ff"Ta5d6ffnameTa5d6ff"Tb4b4b4: Te6edf3nameTb4b4b4,

Ta5d6ff"Ta5d6ffpathTa5d6ff"Tb4b4b4: Te6edf3pathTb4b4b4,

Ta5d6ff"Ta5d6ffhashTa5d6ff"Tb4b4b4: Te6edf3identity_hashTb4b4b4,

Tb4b4b4}

Tff7b72def Td2a8fflist_management_identitiesTb4b4b4(

Te6edf3reticulum_config_dirTb4b4b4: Tffa657str Tff7b72| Tff7b72NoneTb4b4b4,

Tb4b4b4) Tff7b72-Tff7b72> Tffa657listTb4b4b4[Tffa657dictTb4b4b4[Tffa657strTb4b4b4, Te6edf3AnyTb4b4b4]Tb4b4b4]Tb4b4b4:

T8b949e"""List identity files under the RNS identities directory."""

Te6edf3directory Tff7b72= Te6edf3identities_dirTb4b4b4(Te6edf3reticulum_config_dirTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3directoryTb4b4b4)Tb4b4b4:

Tff7b72return Tb4b4b4[Tb4b4b4]

Te6edf3resultsTb4b4b4: Tffa657listTb4b4b4[Tffa657dictTb4b4b4[Tffa657strTb4b4b4, Te6edf3AnyTb4b4b4]Tb4b4b4] Tff7b72= Tb4b4b4[Tb4b4b4]

Tff7b72tryTb4b4b4:

Te6edf3entries Tff7b72= Tffa657sortedTb4b4b4(Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Te6edf3directoryTb4b4b4)Tb4b4b4)

Tff7b72except Tf85149OSErrorTb4b4b4:

Tff7b72return Tb4b4b4[Tb4b4b4]

Tff7b72for Te6edf3entry Tff7b72in Te6edf3entriesTb4b4b4:

Te6edf3path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3directoryTb4b4b4, Te6edf3entryTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisfileTb4b4b4(Te6edf3pathTb4b4b4)Tb4b4b4:

Tff7b72continue

Te6edf3info Tff7b72= Te6edf3_identity_infoTb4b4b4(Te6edf3pathTb4b4b4, Te6edf3entryTb4b4b4)

Tff7b72if Te6edf3info Tff7b72is Tff7b72not Tff7b72NoneTb4b4b4:

Te6edf3resultsTff7b72.Td2a8ffappendTb4b4b4(Te6edf3infoTb4b4b4)

Tff7b72return Te6edf3results

Tff7b72def Td2a8ffcreate_management_identityTb4b4b4(

Te6edf3reticulum_config_dirTb4b4b4: Tffa657str Tff7b72| Tff7b72NoneTb4b4b4,

Te6edf3nameTb4b4b4: Tffa657strTb4b4b4,

Tff7b72*Tb4b4b4,

Te6edf3forceTb4b4b4: Tffa657bool Tff7b72= Tff7b72FalseTb4b4b4,

Tb4b4b4) Tff7b72-Tff7b72> Tffa657dictTb4b4b4[Tffa657strTb4b4b4, Te6edf3AnyTb4b4b4]Tb4b4b4:

T8b949e"""Generate a new RNS identity file under the identities directory."""

Te6edf3cleaned Tff7b72= Te6edf3_safe_nameTb4b4b4(Te6edf3nameTb4b4b4)

Te6edf3directory Tff7b72= Te6edf3identities_dirTb4b4b4(Te6edf3reticulum_config_dirTb4b4b4)

Te6edf3osTff7b72.Td2a8ffmakedirsTb4b4b4(Te6edf3directoryTb4b4b4, Te6edf3exist_okTff7b72=Tff7b72TrueTb4b4b4)

Te6edf3path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3directoryTb4b4b4, Te6edf3cleanedTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3pathTb4b4b4) Tff7b72and Tff7b72not Te6edf3forceTb4b4b4:

Tff7b72raise Tf85149FileExistsErrorTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffIdentity file already exists: Tffd700{Te6edf3cleanedTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3identity Tff7b72= Te6edf3RNSTff7b72.Td2a8ffIdentityTb4b4b4(Tb4b4b4)

Te6edf3identityTff7b72.Td2a8ffto_fileTb4b4b4(Te6edf3pathTb4b4b4)

Te6edf3info Tff7b72= Te6edf3_identity_infoTb4b4b4(Te6edf3pathTb4b4b4, Te6edf3cleanedTb4b4b4)

Tff7b72if Te6edf3info Tff7b72is Tff7b72NoneTb4b4b4:

Tff7b72raise Tf85149RuntimeErrorTb4b4b4(Ta5d6ff"Ta5d6ffCreated identity file but failed to reload itTa5d6ff"Tb4b4b4)

Tff7b72return Te6edf3info

Tff7b72def Td2a8ffresolve_identity_pathTb4b4b4(

Te6edf3reticulum_config_dirTb4b4b4: Tffa657str Tff7b72| Tff7b72NoneTb4b4b4,

Te6edf3identity_pathTb4b4b4: Tffa657str Tff7b72| Tff7b72None Tff7b72= Tff7b72NoneTb4b4b4,

Te6edf3identity_nameTb4b4b4: Tffa657str Tff7b72| Tff7b72None Tff7b72= Tff7b72NoneTb4b4b4,

Tb4b4b4) Tff7b72-Tff7b72> Tffa657strTb4b4b4:

T8b949e"""Resolve a management identity file path from path or short name."""

Tff7b72if Tffa657isinstanceTb4b4b4(Te6edf3identity_pathTb4b4b4, Tffa657strTb4b4b4) Tff7b72and Te6edf3identity_pathTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4:

Te6edf3path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexpanduserTb4b4b4(Te6edf3identity_pathTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisfileTb4b4b4(Te6edf3pathTb4b4b4)Tb4b4b4:

Tff7b72raise Tf85149FileNotFoundErrorTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffIdentity file not found: Tffd700{Te6edf3pathTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Te6edf3path

Tff7b72if Tffa657isinstanceTb4b4b4(Te6edf3identity_nameTb4b4b4, Tffa657strTb4b4b4) Tff7b72and Te6edf3identity_nameTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4:

Te6edf3cleaned Tff7b72= Te6edf3_safe_nameTb4b4b4(Te6edf3identity_nameTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4)

Te6edf3path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3identities_dirTb4b4b4(Te6edf3reticulum_config_dirTb4b4b4)Tb4b4b4, Te6edf3cleanedTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisfileTb4b4b4(Te6edf3pathTb4b4b4)Tb4b4b4:

Tff7b72raise Tf85149FileNotFoundErrorTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffIdentity file not found: Tffd700{Te6edf3cleanedTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Te6edf3path

Tff7b72raise Tf85149ValueErrorTb4b4b4(Ta5d6ff"Ta5d6ffidentity_path or identity_name is requiredTa5d6ff"Tb4b4b4)